外观
VitePress 上手笔记
记录一下这套博客的骨架，以后忘了就翻这篇。
目录结构
myblog/
├─ docs/ ← 所有内容（markdown）
│ ├─ .vitepress/
│ │ ├─ config.mts 主配置（导航、侧栏、私密闸门）
│ │ ├─ teekConfig.ts 主题配置（首页 Banner、博主卡片、页脚）
│ │ └─ theme/index.ts 挂载 Teek 主题
│ ├─ index.md 首页
│ ├─ 绘画/ 编程/ 生活/ 杂项/ 四个分类
│ └─ _private/ 私密区（不会进公开构建）
└─ scripts/check-public.mjs 发布前防呆脚本1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
常用命令
| 命令 | 作用 |
|---|---|
npm run dev | 本地预览（含私密区），http://localhost:5173 |
npm run build | 公开构建，自动排除私密区 |
npm run build:all | 连私密区一起构建（仅本机自测） |
npm run check | 扫产物，发现私密内容就中止 |
npm run preview | 预览构建产物 |
私密是怎么实现的
两道锁：
- 构建排除：
config.mts里的srcExclude在非build:all时排除_private/**， 私密页面直接不生成 —— 不是藏链接，是根本没有这个页面。 - 导航隐藏：导航里的「🔒 私密」条目只在
build:all时出现。
再加 scripts/check-public.mjs 这道保险：它扫构建产物，发现 _private 路径或 私密文件里的哨兵字符串就报错退出，防止哪天配置写错了把私密内容发出去。
踩坑记录
（以后遇到问题就往这里加）